Changes the color of a window’s palette entry.

void AnimateEntry (
    WindowRef dstWindow, 
    SInt16 dstEntry, 
    const RGBColor *srcRGB
);

Parameter descriptions

dstWindow

A pointer to the window whose palette color is to be changed.

dstEntry

The palette entry to be changed.

srcRGB

A pointer to the new RGB value.

DISCUSSION

The AnimateEntry function changes the RGB value of an animated entry for a window’s palette. Each device for which that index has been reserved is immediately modified to contain the new value. This is not considered to be a change to the device’s color environment because no other windows should be using the animated entry.

If the palette entry is not an animated color or if the associated indexes are no longer reserved, no animation occurs.

If you have blocked color updates in a window by using SetPalette with cUpdates set to FALSE, you may observe unintentional animation. This occurs when ActivatePalette reserves for animation device indexes that are already used in the window. Redrawing the window, which normally is the result of a color update event, removes any animated colors that do not belong to the window.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)